package com.ruoyi.system.service;

import java.util.List;

import com.ruoyi.system.domain.SysPost;

/**
 * 岗位信息 服务层
 *
 * @author ruoyi
 */
public interface ISysPostService {
    /**
     * 查询岗位信息集合
     *
     * @param post 岗位信息对象，用于封装查询条件
     * @return 符合条件的岗位信息列表
     */
    public List<SysPost> selectPostList(SysPost post);

    /**
     * 查询所有岗位
     *
     * @return 所有岗位信息列表
     */
    public List<SysPost> selectPostAll();

    /**
     * 通过岗位ID查询岗位信息
     *
     * @param postId 岗位唯一标识ID
     * @return 对应ID的岗位信息对象
     */
    public SysPost selectPostById(Long postId);

    /**
     * 根据用户ID获取岗位选择框列表
     *
     * @param userId 用户唯一标识ID
     * @return 该用户关联的岗位ID列表
     */
    public List<Long> selectPostListByUserId(Long userId);

    /**
     * 校验岗位名称是否唯一
     *
     * @param post 包含岗位名称的岗位信息对象
     * @return 岗位名称是否唯一的校验结果，true表示唯一，false表示不唯一
     */
    public boolean checkPostNameUnique(SysPost post);

    /**
     * 校验岗位编码是否唯一
     *
     * @param post 包含岗位编码的岗位信息对象
     * @return 岗位编码是否唯一的校验结果，true表示唯一，false表示不唯一
     */
    public boolean checkPostCodeUnique(SysPost post);

    /**
     * 通过岗位ID查询岗位使用数量（即关联用户数）
     *
     * @param postId 岗位唯一标识ID
     * @return 使用该岗位的用户数量
     */
    public int countUserPostById(Long postId);

    /**
     * 删除岗位信息
     *
     * @param postId 待删除的岗位ID
     * @return 删除操作影响的记录数
     */
    public int deletePostById(Long postId);

    /**
     * 批量删除岗位信息
     *
     * @param postIds 需要删除的岗位ID数组
     * @return 删除操作影响的记录数
     */
    public int deletePostByIds(Long[] postIds);

    /**
     * 新增保存岗位信息
     *
     * @param post 待新增的岗位信息对象
     * @return 插入操作影响的记录数
     */
    public int insertPost(SysPost post);

    /**
     * 修改保存岗位信息
     *
     * @param post 待更新的岗位信息对象
     * @return 更新操作影响的记录数
     */
    public int updatePost(SysPost post);
}
